home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / prog / pbasmlib.arj / README.1ST < prev    next >
Text File  |  1994-02-12  |  3KB  |  67 lines
  1. PBASMLIB V1.0
  2. (C) Copyright 1994 by Tim Gerchmez
  3. All Rights Reserved.
  4. --------------------
  5.  
  6. Hello, and welcome to PBASMLIB version 1.0, an all-assembly language
  7. toolbox for PowerBASIC 3.0.  PBASMLIB includes hundreds of low-level
  8. routines that give you access to DOS, BIOS, Mouse driver, Soundblaster,
  9. EMS, XMS and other system-level functions with the lightning speed and
  10. small code size of pure assembly language.  You don't have to know assembly
  11. language to use these routines, however.  Using them is as easy as calling
  12. a regular PowerBASIC subprogram or function.
  13.  
  14.  
  15. Installing PBASMLIB
  16. -------------------
  17.  
  18. To install PBASMLIB, first create a new directory under your main 
  19. PowerBASIC directory to hold all the files.  You can do this with
  20. a command similar to the following:
  21.  
  22. MD C:\PB3\PBASMLIB
  23.  
  24. Next, copy all the files in this package to the newly-created directory
  25. with a command similar to the following:
  26.  
  27. COPY *.* C:\PB3\PBASMLIB
  28.  
  29. After this, you should copy PBASMLIB.PBL to your PowerBASIC LINK directory,
  30. and PBASMLIB.INC to PowerBASIC's INCLUDE directory.  These are the directories
  31. specified in the OPTIONS/DIRECTORIES menu in the PowerBASIC IDE.  PowerBASIC
  32. needs to know where to find PBASMLIB.PBL and PBASMLIB.INC when linking
  33. routines into your programs.  To copy these files, use a command sequence
  34. similar to the following:
  35.  
  36. CD C:\PB3\PBASMLIB
  37. COPY PBASMLIB.PBL C:\PB3\PBU  (or C:\PB3\LINK)
  38. COPY PBASMLIB.INC C:\PB3\INCLUDE
  39.  
  40. You can optionally always switch to the PBASMLIB directory before compiling
  41. and linking PBASMLIB programs, but it's far more convenient to tell PowerBASIC
  42. where to find .PBL/.PBU and .INC files.  For more information on default
  43. PowerBASIC directories, see the online help or consult the PowerBASIC manuals.
  44.  
  45. Once you've installed PBASMLIB, the routines should be ready to use.  They
  46. will all be immediately accessible to your programs by including the following
  47. commands at the top of programs that use PBASMLIB routines:
  48.  
  49. $LINK "PBASMLIB.PBL"
  50. $INCLUDE "PBASMLIB.INC"
  51.  
  52. If you're using a version of PowerBASIC earlier than 3.0C, it may be
  53. necessary to declare only the routines that you actually use in your
  54. programs, otherwise PowerBASIC may pull in the entire PBASMLIB library,
  55. making your programs larger than necessary.  If you use an earlier version
  56. of PowerBASIC, eliminate the $INCLUDE "PBASMLIB.INC" in your programs, and
  57. use cut and paste to cut the DECLAREs for routines you need out of the
  58. PBASMLIB.INC file and paste them into your programs.
  59.  
  60. You are now ready to try the demo programs included with PBASMLIB.  As of
  61. this version, most of the demos are for the SOUND (Soundblaster) module.
  62. If you don't have a Soundblaster card, you can't use these demo programs.
  63. A .DOC file for each module in PBASMLIB is included (XXXXX.DOC) that details
  64. the routines available in each module.  Also, please read PBASMLIB.DOC for
  65. further information on PBASMLIB as a whole.
  66.  
  67.